COMMENT ⊗   VALID 00003 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	**** Changes to Monitor Command Manual, 3rd edition, SAILON 54.5, Jan. 1976 ****
C00032 00003	12/9/77 -- EREAD and READ monitor commands run E.
C00044 ENDMK
C⊗;
**** Changes to Monitor Command Manual, 3rd edition, SAILON 54.5, Jan. 1976 ****

3/4/76 -- ME
The COOKIE option in LOGIN doesn't work if you have LOGRUN, INIT, or
PORNO option.  Precedence of these four mutually exclusive options is
(highest first): LOGRUN, INIT, PORNO, COOKIE.

3/5/76 -- ME
ESC Z or TTY BEEP will now cause your TTY to be beeped when your job
has finished doing something that took more than 15 seconds.  BREAK Z
or TTY-BEEP disable this feature.  MAIL comments and complaints to ME.
More precisely, if you are enabled for this automatic beeping, then
you will be beeped ("bell"ed on a non-display) when your job enters
STOPQ, or IOWQ for TTY input, or INTWQ for TTY interrupts only,
provided that your job's incremental wait time is 15 seconds (real
time) or greater.  A job's incremental wait time is the amount of
time spent waiting for the system since the last command was given
that caused the program to leave TTY input IOWQ or STOPQ.  This wait
time corresponds precisely to the incremental run time displayed on
the wholine--both incremental times are reset at the same instant.
Also, if you type BREAK X or TTY NO UPDATE or a similar command which
causes the incremental times never to be reset, then you will never
be beeped automatically (until you type ESC X or TTY UPDATE or other
similar command to restore the resettability of the incremental
times).  Non-ARPA PTYs are never beeped.

3/5/76 -- ME
In the line editor, CONTROL-K followed by RETURN will kill characters
from the cursor to the end of the line.  Similarly, CONTROL-S RETURN
will skip to the end of the line.

3/5/76 -- ME
In the line editor, CLEAR followed by CONTROL-RETURN will reload your
line editor with the text that was in it when CLEAR was typed, unless
the CONTROL-RETURN reloading feature is disabled by the program (e.g., E).
There is one special side effect of this feature: If you type RETURN
after doing a CLEAR and a CONTROL-RETURN, the line will be activated
and ended with a carriage return and a linefeed, EVEN IF THE LINE
ALREADY CONTAINED AN ACTIVATOR (altmode or linefeed).  This may
occasionally be useful if, for instance you or your program reloads
the line editor with a line ended with a null.  In this case, typing
RETURN would normally not cause a CR and LF to follow the text into
the TTY input buffer, but CLEAR, CONTROL-RETURN, RETURN will cause
the CR and LF to be transmitted to the input buffer!

3/9/76 -- REG
BEEP option in LOGIN causes the beep after waiting (ESC Z) feature to
be enabled.

Additional documentation about LOGIN:

If the command L or LOGIN with no argument is typed, LOGIN will prompt,
with #, for the PPN.

If LOGIN asks for a password and a blank one is supplied (by typing
return), then LOGIN assumes that the user typed the wrong PPN and now
wants to correct that error.  LOGIN prompts for a new PPN by typing #.

3/31/76 -- ME
The new /UFDPRO switch in COPY causes the DIRECTORY command (or
/SEARCH switch) to type out the UFD protection and the UFD's default
file protection for each PPN for which a header is listed.  These two
protection codes are output on the PPN's header line in the following
form:

   [PRJ,PRG]	UFD PRO=405; DEF PRO=000

The /UFDPRO switch (which currently can be abbreviated /U) is implied
by /FULL and by /PROTECTION (in a DIRECTORY command).  The /FULL
switch now prints this header line in addition to listing each file's
PPN on its own line.

To get just these protections typed out (without listing any files),
use /Q/F/U, e.g.,

DI/Q/F/U

Like the other directory switches (/PROTECTION, /WRITER, /DUMPED,
etc.), the /UFDPRO switch is sticky no matter where it occurs.  For
instance, to see the UFD protection and the dump date of files named
FOO and BAZ, use:

DI FOO,BAZ/DUMP/UFD

Note that if none of the files named exists, then the PPN header is
not printed and so the UFD protection will not be listed.

4/2/76 -- ME
MAIL now does not generate the warning "nonstandard page printer
geometry may obscure message" if either the current PP or PP 0 has
default dimensions.  Also, MAIL #LOGOUT will assume default /-E
unless /E given explicitly (this creates file LOGOUT.MSG which is
typed and deleted when you log out).

6/15/76 -- ME
The COPY switch /FULL now implies /DUMPED on non-displays as well as
on displays.  Also, DIRECTORY now implies /TIME on non-displays as
well as on displays.

6/18/76 -- REG
START, CSTART, REENTER and DDT commands will clear PCPUBL on the KL10.

6/25/76 -- REG
DART system-class dumps will not dump files with the extension SND.

6/27/76 -- MJC (by ME)
SNAIL: RER and RERUN now interpret any core size arg as number of pages.
Slash may end PPN (i.e., right square bracket may be omitted).
Starting SNAIL at starting address minus one causes it to read and
process the ED commmand file.
"PROCESS @" loads the contents of the CM command file into the line editor.

7/23/76 -- ME
DM lines are now displays with full display capabilities.  HELP DMKEY works.
DD screen no longer redraw on RESET/DPYCLR unless necessary.
DM line becomes "available" 5 seconds after logout.
DM high-speed phone line count on system wholine.
Default DM page printer parameters are 3 lines/glitch and 7 glitches/screen.

8/16/76 -- ME
ESC CALL puts you in DD channel wait queue if no channels available.
BRK CALL removes you from queue.
You get beeped when added to or removed from queue;
these beeps are not disabled by BREAK B (which disables normal beeps).
DD count on system wholine includes size of queue of waiters.

On DMs:
- - - -
User part of wholine is only output if it has changed in any respect;
however, if ESC C (or other escape command that erases whole screen) has
been typed, user part is forced to be output again.  ESC and META are
beeping no-ops if the line is not initialized.  TTY TABS command causes
terminal's tab stops to be set immediately; TTY NO TABS causes conversion
of tabs to equivalent numbers of spaces--TTY TABS is default.  When output
is being held, the line editor appears on the HOLDING message line.

8/22/76 -- ME
COPY has been modified to know about DMs.  In particular, it displays the
number of the current page of the input file in the upper right corner when
reading a file in ASCII mode, like on DD and III.  Also, the "ANDYSW" mode of
putting out ?<char> for certain non-printable characters has been flushed.

11/28/76 -- BH
The super duper all-system filename scanner in FTP has been modified so that
the filenames < and > are ignored for local purposes iff the server at the
other end is an ITS.  Otherwise they are the beginning of a TENEX user name
and a syntax error, respectively, as before.  Note that the string "> FUBAR"
will use FUBAR as the local filename, not FUB as the local extension.  Also,
in RPPN mode, any number of tokens separated by commas may appear within
square brackets, not just two as before.  This is for TOPS-10 SFDs.  This
change has been added to the MONCOM source file.

4/8/77 -- ME
New commands TTY ESCAPE and TTY BREAK allow all users, especially those
on non-displays, to enter ESCAPE/BREAK commands.  The format is
	TTY ESCAPE n x   or   TTY BREAK n x
where n is an optional unsigned number and x is the escape/break command
character.  The only commands currently significant on non-displays are
ESC/BRK I,F,X,Z; of these, the only one not previously available through
some other command is ESC I to interrupt a program.

4/11/77 -- ME 
New line editor commands:
αT  Transposes previous two characters in the line (if two or more to left)
αB  searches Backwards for the next character typed (like αS but backwards)
αL  kills backwards up to the next character typed (like αK but backwards)
The SUPCT bit (0,,40000) in the fourth word of the special activation
table (SETACT UUO) suppresses all of these commands; with SUPCT bit on,
these commands become normal user typein.

Also, the αR line editor command repeats the last-given forward or backward
search or kill command (αS, αK, αB, αL).

11/19/77 -- MRC
You may now use the /REPEAT and /HOLD switches with XSPOOL and may
queue to the XGP spooler when it is down, as has always been allowed with
the lineprinter spooler.  The reason for this is that these semi-
administrative controls do not prevent people from being losers with
leaving their listings around the XGP, but do prevent legitimate usage of
these features.  Also, according to Les it is actually cheaper to make
multiple copies on the XGP than to Xerox them!

PPN parsing is now intelligent; null fields now default to the
appropriate field in the ALIAS PPN (not the login PPN, by popular
request).  Almost any construct with PPN's that are meaningful but used to
be barfed at now work.

You can now unspool any job (ie, use the "privileged unspool") if you
use the /ALL switch in the UNSPOOL command.

SPOOL now defaults to .LPT if no extension is specified and no file
exists with the null extension.

XSPOOL now defaults to .XGP if no extension is specified and no file
exists with the null extension.

11/24/77 -- BH
Yet another change to FTP's universal file name parser.  If you are
talking to an ITS and your pathname contains a dot (.) not preceded
by a token, and if the dot is immediately (no space) followed by a
token, then the dot is ignored, and if the token is immediately
followed by a dot that one is ignored too.  Thus, the command
	GET .INFO.;TECO ORDER
is equivalent to
	GET INFO;TECO ORDER

11/26/77 -- BH

The BATCH command now has a time limit feature, to ameliorate the
problem of runaway batch jobs.  The feature is controlled by the
/LIMIT or /TLIMIT switch (the two names are equivalent) in the form
	/TLIMIT=mins	or	/TLIMIT=hrs:mins
The switch is given with other batch switches, right after the
command name.  The form /TLIMIT=∞ may be used for an infinite limit.
THE DEFAULT TIME LIMIT IS ONE HOUR for jobs submitted for later
execution, and is INFINITE for jobs run immediately with the /NOW
switch.  (Presumably the latter case implies that the user is watching
the job run and can interrupt it himself if necessary.)

The limit applies to the job's runtime (CPU time), not realtime.
The BATCH controller takes clock interrupts every two (real) minutes
to check the controlled job's runtime, so the time limit may in fact
be slightly exceeded before the job is stopped.  If the job runs over
its time limit, it is logged out immediately; the log file will end
with a line saying
	? BATCH: time limit exceeded.

11/27/77 -- BH

If you only want to do one file transfer command it is now possible to
do the whole thing in just one monitor command line, without hassle.
Just give a monitor command of the form

	FTP local ← {host}remote
	FTP local → {host}remote
	FTP {host}remote ← local
	FTP {host}remote → local

(Those are real braces--you type them!)  The direction of the arrow
indicates the direction of the transfer.  People on non-SAIL terminals
without right arrow can always use left arrow, since the remote file
pathname may be given first in this format.  (The rules for doing
things the old way are unchanged.)  Therefore, an equal sign may not
be used as the delimiter; it must be an arrow to indicate the direction
of the transfer.

Although there must be an arrow, either of the pathnames may be null,
in which case the other one will be used for both ends as in the old
system when only one pathname is given.

Normally FTP will attempt to do the transfer in image mode, 36 bit.
If you want ASCII mode transfer, give the command as above, but with
"FTP/A" instead of just "FTP".  If the remote host will not accept
the specified mode, the transfer is aborted and you can try negotiating
manually.

After doing the transfer successfully, FTP will close the connection
and exit.  So if you want to do several transfer commands, it pays
to do it the old way rather than several of these new commands.

11/27/77 -- MRC
The UFD monitor command allows users to create a directory on DSK or
a UDP.  This is the only a new account can be created remotely.
"UFD ?" gives details, but briefly the command format is
UFD device:project-name,programmer-name <CR>
and then you are asked password and file protection questions.  Alternatively,
if the directory exists and is empty you are asked if you want to
delete it.  UFD tries to lead you by the hand as much as possible.

11/27/77 -- MRC
While we are at it, the SUPDUP or SD monitor command starts up a SUPDUP
(SUPer DUPer image telnet).  The command form is SUPDUP host-name.  Only
A{I}, D{M}, ML, and MC are recognized so far as only they currently
provide SUPDUP service.  SUPDUP is a display TELNET protocol that allows
a user to be a display on the server's host independent of what are the
actual display codes.  Since SUPDUP supports bucky bits and the full ITS
character set, a user on a Data Disc can be effectivly a TV user at MIT.
Besides display service, it is (or should be) much faster than TELNET.

11/27/77 -- MRC
LOGIN now has the following new options:

The XMAIL option says do not type out a "Message from ..." mail
notification if you were the last person to write your mail file.  This
includes writes by MAIL; if enough people want that changed, it will be.

The XDIGEST option says always type out the AP news digest if you
have not seen it, whether or not NOMAIL is set.  It doesn't require DIGEST
to be set (ie, it turns on DIGEST).

The NONOTE option says never type out notices.  This is useful for
people who log in on multiple accounts but only want to see notices on
one (but still want their OPTION.TXT executed).

The SYSTAT option types out the number of logged-in jobs and the
number of jobs running at the current time (this is the old message that
guest users used to get).

LOGIN xxx where xxx is a programmer name logs you in as if you typed
LOGIN 1/xxx.  This is LOGIN's end of the master PPN feature.

LOGIN xxx pppppp where xxx is a programmer name and pppppp is a
password logs you in as 1/xxx, password pppppp.  This is a Tenex-style
of LOGIN.  Note that your password IS echoed with this style of login.
This is just for people who want to log in this way; you don't have to
use it if you don't want it.  It is slightly more efficient to use this
way (in the order of a few microseconds).

11/30/77 - BH

The one-line FTP command format now allows you to specify a particular
USER and PASSword to be sent to the remote host instead of the default
USER ANONYMOUS and PASS SAIL.  The format is to use
	{host/user}
instead of simply {host} in the command line.  If a password is
required, you will be asked to provide it later, with echoing turned off.
Example:
	FTP ←{SRI/NICGUEST}LIAISONS.TXT
will connect to SRI-KL, send USER NICGUEST and the password you supply
later, and copy their file <NICGUEST>LIAISONS.TXT into your local file
LIAISO.TXT all in one swell foop.

12/2/77 - BH

For people who want to store files on TENEXes, you have to be able
to send an ACCT command.  Therefore, the one-line format will now
accept a host specification in the form
	{host/user/acct}

That's rather a lot of typing.  Therefore, it is now possible to
keep all this information in your OPTION.TXT file.  Here's how:
in the FTP monitor command, use a host specification of the form
	{name↑}
(actually the right brace is optional, but it looks nice).  FTP
will then read your LOGIN PPN's OPTION.TXT file (not alias PPN)
looking for one or more lines starting "FTP:".  These lines should
contain one or more host definitions in any of these forms:
	{name:host/user}
	{name:host/user/acct}
	{name:host/user/acct/password}
	{name/user}
	{name/user/acct}
	{name/user/acct/password}
In the latter three cases, "name" also serves to identify the host.
ACCT can be empty to avoid sending an account number, e.g., {SRI/USER//PASSW}
Note that passwords are stored online at your own risk.  If you don't
include a password and one is needed, FTP will ask you and turn off
echoing as usual.  Note that the "name" you type must match the "name"
in OPTION.TXT exactly (except for case of letters); if you habitually
use an abbreviated version of a host name, that's what you should put
in OPTION.TXT too.

Example: (fictitious accounts, John, don't bother trying it)
In your OPTION.TXT you have
	FTP:{SUM/SU-AI/STAFF/FOO},{NET:SRI/NETPROG/NIC}
The command
	FTP →{SUM↑}FOO.BAR
will copy local file FOO.BAR to <SU-AI>FOO.BAR at SUMEX without
asking any more questions.  The command
	FTP ←{NET↑}FOO.BAR
will ask you for a password and copy <NETPROG>FOO.BAR at SRI-KL into
local file FOO.BAR.

An additional INCOMPATIBLE CHANGE to FTP is that LPPN is now the default
mode instead of RPPN.  This means that the one-line command
	FTP ←{SRI}<NETINFO>LIAISON.TXT[NET,DOC]
or the old-style
	RETR <NETINFO>LIAISON.TXT[NET,DOC]
will use local file LIAISO.TXT[NET,DOC] and remote file <NETINFO>LIAISON.TXT
instead of using local!file LIAISO.TXT[your alias] and trying for remote
file <NETINFO>LIAISON.TXT[NET,DOC] as it previously did.  This is probably
just what you wanted unless you are using CMU, in which case I'm not sure
whether it is or not.  In a one-line FTP command, use the /R switch (i.e.,
start the command FTP/R) to get RPPN mode.

In the past, to retrieve a file and direct it to your terminal, you
had to give a command like
	RETR TTY:FOO←REMOTE.FILE
because if you left out the FOO the transfer was considered a multiple
(wildcard) operation for lack of a local filename.  There is now a TTY
command to do this; the format is
	TTY REMOTE.FILE
or, for a one-line FTP operation,
	FTP/T {HOST}REMOTE.FILE
Note that this is the only form of one-liner which does not require (or
in fact permit) a ← or → delimiter.  Also, /T implies /A.

12/6/77 - MRC

LOGIN now allows slash as a delimiter in OPTION.TXT like comma.

The RUN=filespec option allows an arbitrary program to be run.  The device
defaults to SYS:; there is no filename or PPN default.  RUN is another
mutually exclusive option, and has highest priority (ie, it is selected
before LOGRUN, etc...).

The INIT and LOGRUN options are now considered "obsolete", since
RUN=DSK:INIT and RUN=LOGRUN are equivalent and more general.  However,
these options will remain so OPTION.TXT files will not be broken.

You never have to specify project 1 now.  If you wish to do other than
a "/" login, just prefix the programmer name with the delimiter of your
choice.  For example:  LOGIN MRC and L /MRC are now equivalent, and of
course L .MRC does the obvious thing.

LOGIN now tells you if you have an illegal option in your OPTION.TXT.

LOGIN allows multi-line OPTION.TXT entries; carriage return is now treated
like space, so:

LOGIN:foo,bar,
 garply;

is the same as LOGIN:foo,bar,garply;
12/9/77 -- EREAD and READ monitor commands run E.

EREAD edits the given file in /R mode.
READ tries to find a documentation file with the given name
   and then edits it in /R mode.

12/25/77 -- BH

Ending a MAIL (or SEND etc) command line with ALT goes to E, like αβE
on a non-command message line.

12/26/77 - MRC

The mail notification is always reported if J=MAIL wrote the mail file,
regardless of the setting of XMAIL.

12/28/77 - MRC
DIAL, PTYJOB, OTELNET and NT now use ↑↑ as the buckyifier instead of
↑E.
The TELNET monitor command no longer runs T but instead runs a (for the
present) largely compatible program documented in TELNET.MRC[UP,DOC].

1/9/78 - BH

TTY [NO] GAG sets/clears a bit which prevents the TALK command and the
TTYMES UUO to your terminal (except TTYMES to SIXBIT /TTY/ from your
own job).

TTY [NO] CONVERT clears/sets a bit which prevents SAIL/ASCII conversion
of right brace, tilde, altmode, and not-equal.  The bit is used only
for physical terminals (not PTYs) which are not displays.  The problem
doesn't arise for DD and III displays; DMs and ARPAnet PTYs always
convert; non-ARPAnet PTYs never convert.  Conversion based on this
bit applies only to characters physically typed at the terminal, not to
characters written by PTYUUO.  Note that the sense of the bit is opposite
from the sense of the command; TTY CONVERT clears the bit and is the
default.  If you have a model 33 whose altmode key does not generate
33 octal, you need TTY NO CONVERT.

Note by ME -- The CONVERT bit applies on both input and output.

The TALK command types out ";; Link from FOO " on the terminals linked
to, where FOO is the programmer name if the linking TTY is logged in,
or the TTY name otherwise.  Typing CALL (or ↑C) to leave the link
types ";; Bye from FOO" on all TTYs remaining in the link, unless
only one other TTY was in the link, in which case ";; Link broken"
is typed.  TALK is always allowed, even if the target terminal is in
user mode, unless it is holding or has said TTY GAG.  The TLK privilege
no longer exists.

LOGIN with % now acts like / rather than , for message typeout.  There
is a new delimiter ! which is like / but requires a password even if
it is a remote-only password and you are loggin in locally; this is
because LOGIN will not grant privileges (except LUP and LIV) without
a password.

1/11/78 - ME

The monitor commands ATTACH, KILL, FINISH, and RESET (new command) now
all accept an optional job number and PPN for the job to affect.  If a
job number is given without PPN, your own PPN is assumed.  If no job
number or PPN is given, FINISH and RESET affect your own job, ATTACH
attaches the first detached job of yours, and KILL gives an error
message.  In all cases where you are doing one of these commands to
another job, that job's terminal gets a message saying what is
happening and who is doing it.  If you use any of these commands on a
job with a different PPN from your own, then a similar message is
logged on the CTY.  None of these commands requires any privileges,
except that the ATTACH command requires the ATT privilege to attach a
phantom -- normal users shouldn't ever need to do that.  Anyone
maliciously using any of these commands on another user will be dealt
with severely.

When you KILL a job, any files that job has open for writing are
discarded, as would happen if a RESET were done for that job.  If you
want to close (and keep) any files the job has open for writing, then
you should FINISH the job before you KILL it.

If you try to ATTACH a job that is already attached (elsewhere), then
the job is detached from its attached terminal and attached to yours.

The RESET command executes a RESET UUO (to flush files, etc.) without
otherwise changing core or core size.

The FLUSH command requires the UPG privilege to flush a terminal
that is in use (has a job logged in).  However, ENABLE UPG will work
for anyone (must be done once per FLUSH command given).

TALK <programmer name> now works if the given person is logged in
on exactly one terminal.

The only privileges that can now be enabled by the ENABLE monitor
command are UPG (for FLUSHing a terminal in use), LUP (if you're
really on a local terminal), and LIV (for suppressing autologout).
Anyone can enable UPG and LIV, but only jobs on local terminals
can enable LUP.

See also NEWPRV.JBR[S,DOC] for details about changes in the privilege
system.

1/12/78 -- ME
The spoolers now notify *,<programmer> about anything spooled
by <any project>,<programmer>.

1/13/78 -- JBR
New command DSKSIZ.

DSKSIZ PRG tells you how much space programmer PRG is allocated and using
on the disk.  It can also tell you what files the purger would delete to
get programmer PRG under allocation.  DSKSIZ accepts the switch /Q to
suppress asking questions about output files.

Each line of DSKSIZ output is in the following format:
[PRJ,PRG]  n Files.  t T.  w DW.  p%  Date
This means that disk area PRJ,PRG has n files occupying t disk tracks and
w disk words (each track is 2334. words) with a storage efficiency of p%.
Date is the date of the most recently written file in the area.

1/13/78 -- JBR
New command UNDELE.

UNDELE A←B tries to find deleted file B and undelete it, writing it out
as a new file, A.

1/16/78 -- ME
ESC Q to see another of the same programmer's jobs on the wholine
sets things up so that ESC * will redraw that same wholine rather
than do another ESC Q.

The char "!" appearing after the tty number in the wholine means that the
wholine is for the job attached to the terminal where the wholine appears
and that that terminal is marked as private.  Thus only the owner of a
private terminal will see a "!", which is for informing him and him only
that his terminal is private.

?/?/77 -- ME
αβ<space> and αβ<bs> are repeating line editor cursor movement commands

1/24/78 - bh

ESC|BRK n B does temporary select of audio channel 0 with|without beeps
allowed, for n minutes.

BRK U (no arg) terminates paging interruption if any, else resets temporary
audio map to permanent.

MAIL will send to any PTY which isn't GAGged.

1/25/78 - bh

The temporary selection made by ESC|BRK n B survives resets of the job.
An explicit ADSMAP UUO with argument -1 can reset it, however.

The FINISH command is allowed to a phantom job (JLOG off) without ATTPRV
if the job giving the command has the same PPN as the phantom, and the
programmer name is not SYS.

The PTTY command types out the responsible TV for a DD line.

RCV, when creating a new output file, will create it in non-E format
iff it is not on [2,2] and the source file is also non-E format.

1/28/78 - mrc

there is no longer a buckifier in TELNET.  Read TELNET.MRC[UP,DOC].

1/30/78 - bh

MAIL will send prg mail to MSG.MSG[1,prg] if it exists.  If it exists but
is protected against the mailer, the message will be queued and the remind
phantom will override the protection.

2/7/78 -- ME

The ATTACH command is allowed to a phantom job (JLOG off) without ATTPRV
if the job giving the command has the same PPN as the phantom, and the
programmer name is not SYS.  (Just like FINISH above.)

2/18/78 - bh

The GRIPE command with a single word on the command line after the word
GRIPE (e.g., GRIPE FOO) will try to find an entry of the form BUG-FOO
in the forwarding file, and send the gripe there instead of to GRIPES.TXT.